home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / distill.zip / Distill.TXT < prev   
Text File  |  1997-07-26  |  6KB  |  123 lines

  1. Poor man's Distiller
  2.  
  3. Life would be perfect if Adobe would only release a native OS/2 version 
  4. of the Adobe Acrobat software.  I don't mean the reader; I mean the 
  5. software to actually create Portable Document Format (PDF) files. 
  6. However, since they haven't, I've come up with a workable solution (for 
  7. me) and I figured I'd share it with everyone else who saw the need.
  8.  
  9. There are several software packages you will need to download in order 
  10. to get this to work.  All of them are (at the writing) freeware so the 
  11. only thing this will cost you is some download time.
  12.  
  13. The most important piece of this system is Aladdin Ghostscript.  The 
  14. current version is 5.01, and can be obtained from their web page at 
  15. http://www.cs.wisc.edu/~ghost/  Read the instructions carefully to 
  16. install.  Rename the gsos2.exe program to simply gs.exe.
  17.  
  18. The next package you will need are the EMX Run time libraries.  You 
  19. should be able to find these at http://hobbes.nmsu.edu in the os2/unix 
  20. libraries, usually with the name emxrt.zip.  Again, make sure you read 
  21. the instructions carefully and install the package.  The EMX run time 
  22. libraries are used by quite a few shareware and freeware programs.
  23.  
  24. The next thing you will need is IBM's Visual REXX extensions.  This is a
  25. freeware package distributed through IBM's EWS (Employee Written 
  26. Software) program.  The package name is usually VREXX2.ZIP and should be
  27. available at the hobbes site mentioned above, or any site specializing 
  28. in OS/2 software.  Follow the instructions included in the package to 
  29. install the software.
  30.  
  31. Next, you will need Kai Uwe Rommel's PRINTMON program.  This was also 
  32. available from the hobbes site, and is also freeware.  The installation 
  33. instructions are sparse.  Just copy the PRINTMON.EXE program into a 
  34. directory on your path.
  35.  
  36. Next, you'll need the REXX program in this package, Distill.CMD. 
  37. Copy it into a directory on your path as well.  You will need to modify 
  38. the program slightly before using.  Open it in the text editor of your 
  39. choice and change the "gspath" variable to reflect the drive and 
  40. directory into which you installed Ghostscript, and then modify either 
  41. the "acdir" or "gcdir" variables depending on whether you want to use,
  42. GSView or Acrobat, to view your PDF files.
  43.  
  44. Finally, you will have to create a printer object on your desktop.  Use 
  45. the latest generic Postscript printer drivers (as of this writing they 
  46. are 30.514).  If you are using Warp3 I'd suggest upgrading to the 
  47. Fixpack 26 or higher level.  You should be fine with the base level of 
  48. Warp4.  You can always get the latest printer drivers from the Master 
  49. OS/2 Update Site, http://www.cincyteamos2.org/masterupdate.html
  50.  
  51. There are two ways to use Distill.CMD.  You can create a desktop object 
  52. for it, then drag & drop raw postscript files onto it.  To create a raw 
  53. postscript file, have the printer object print to a file instead of to a
  54. port.  When you print to this object, you will be prompted for a file 
  55. name.  Once the file is created, you can drag and drop that file onto 
  56. the Distill object and you will be prompted for another file name; this 
  57. one will be the PDF file.
  58.  
  59. I don't know about you.  To me, the above sounds a little too 
  60. convoluted.  Instead, I'd leave the printer object directed to a port. 
  61. If you have a STARTUP.CMD file in the root directory of your boot drive,
  62. add the following line:
  63.  
  64. START /MIN PRINTMON LPTx "DISTILL STDIN"
  65.  
  66. where "x" is the port number to which you've assigned the Postscript 
  67. printer.
  68.  
  69. If you do not have a STARTUP.CMD file, create one now with the above 
  70. line.  If your STARTUP.CMD file is written in REXX instead of the 
  71. standard OS/2 batch language, enclose the above line in single quotes.
  72.  
  73. The next time you print to the Postscript printer object, you will hear 
  74. your disk churn a bit, and then a window will pop up prompting you for 
  75. the path and filename for the new Acrobat document.  Enter the 
  76. information and press the "OK" button.  Give it a few moments (till you 
  77. hear the disk stop churning) and you should be able to open your new 
  78. document with the Adobe Acrobat Reader for OS/2 or Russell Lang's 
  79. GSView (depending on how you've configured Distill.CMD)!
  80.  
  81. Please read the PS2PDF.TXT document that comes with Ghostscript to learn
  82. about the limitations to the PDF documents created by Ghostscript.  If 
  83. you have any problems with the Distill.CMD REXX program, please feel 
  84. free to contact me.  If you have problems with any of the other programs
  85. in this system, please refer to the tech support information from their 
  86. authors.
  87.  
  88. And, of course, don't forget to let Adobe know how much you'd REALLY 
  89. like a native version of Acrobat!!
  90.  
  91. Jaime A. Cruz, Jr.
  92. jcruz@ibm.net
  93.  
  94. Revision History:
  95. -----------------
  96.  
  97. 1997/06/27 - Samuel Audet <guardia@cam.org> suggested verifying whether 
  98. or not the PDF file was created.  We couldn't find a way to tell if the 
  99. file created was valid or not (GSOS2.EXE apparently does not pass return
  100. codes) so I decided to give the user the option of launching the Adobe 
  101. Acrobat Reader if the PDF file was created so he can see for himself if 
  102. he was successful.
  103.  
  104. 1997/06/28 - There must be a bug in the REXX interpreter running under 
  105. OS/2 Warp 3, because I was certainly able to retrieve return codes from 
  106. GSOS2.EXE under Warp4 running both ObjectREXX and Classic REXX.  I've 
  107. modified the error code to check for the existence of the PDF file AND a
  108. return code of zero from GSOS2.EXE.  Only then will it prompt the user 
  109. to launch Acrobat.  Also, the new code has the option of launching 
  110. Russell Lang's GSView program instead of Acrobat Reader.  Russell has 
  111. released GSView 2.2 which works with Aladdin's Ghostscript 5.01 so some 
  112. users may prefer to use that instead of Acrobat Reader.
  113.  
  114. 1997/07/07 - Updated the documentation to correct some errors, and 
  115. created a PDF version of the documentation using the IBMWorks word 
  116. processor and Distill.CMD (to prove it works).
  117.  
  118. 1997/07/26 - Updated the Distill.CMD program to end with a return code 
  119. of '4' if no input parameter is given.  Modified the initial dialog box
  120. call to use the VFileBox dialog instead of the VInputBox dialog. 
  121. Corrected a problem where the full path was not being added to the input
  122. file name under all circumstances.
  123.